The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

assets/index.less (2)

82-84: 移除明显的调试配色（红边、绿底），避免误入生产。

这些样式看起来用于调试，会在 UI 上显著可见，建议用中性样式或变量占位，或仅在开发模式注入。

应用以下精简（同时增加 pointer-events 防止遮挡交互）：

   &-float-bg {
     position: absolute;
     z-index: 0;
     box-sizing: border-box;
-    border: 1px solid red;
-    background: green;
+    border: 0;
+    background: transparent;
+    pointer-events: none;

---

96-98: 移除 !important，通过选择器权重或结构优化覆盖样式。

!important 会增加维护成本，应尽量避免。

-  &-unique-controlled {
-    border-color: rgba(0, 0, 0, 0.01) !important;
-    background: transparent !important;
+  &-unique-controlled {
+    border-color: rgba(0, 0, 0, 0.01);
+    background: transparent;

src/hooks/useOffsetStyle.ts (1)

14-14: 移除已完成的 TODO 注释。

此文件正是将 offsetStyle 逻辑抽出到 Hook 的实现，TODO 已完成。

-  // TODO: Move offsetStyle logic to useOffsetStyle.ts hooks

src/UniqueProvider/FloatBg.tsx (3)

12-12: 为 align 使用精确类型 AlignType，提升类型安全。

当前为 any，与 Hook 定义不一致。

-import React from 'react';
+import React from 'react';
+import type { AlignType } from '../interface';
 // ...
 export interface FloatBgProps {
   prefixCls: string; // ${prefixCls}-float-bg
   isMobile: boolean;
   ready: boolean;
   open: boolean;
-  align: any;
+  align: AlignType;

---

39-44: 移除注释掉的临时代码，保持文件整洁。

-  // ========================= Ready ==========================
-  // const [delayReady, setDelayReady] = React.useState(false);
-
-  // React.useEffect(() => {
-  //   setDelayReady(ready);
-  // }, [ready]);

---

66-67: 移除调试注释。

多余注释会干扰阅读。

-  // Remove console.log as it's for debugging only
-  // console.log('>>>', ready, open, offsetStyle);
+  //（已移除调试日志）

src/context.ts (1)

2-2: 为 UniqueShowOptions 去除 any，补全精确类型（重复建议）

将 builtinPlacements/popupAlign/popupMotion/maskMotion/arrow 等从 any 替换为具体类型，改善类型安全与智能提示。

-import type { TriggerProps } from './index';
+import type {
+  TriggerProps,
+  BuildInPlacements,
+  AlignType,
+  ArrowTypeOuter,
+} from './index';
+import type { CSSMotionProps } from '@rc-component/motion';
@@
-  popupPlacement?: string;
-  builtinPlacements?: any;
-  popupAlign?: any;
+  popupPlacement?: string;
+  builtinPlacements?: BuildInPlacements;
+  popupAlign?: AlignType;
   zIndex?: number;
   mask?: boolean;
   maskClosable?: boolean;
-  popupMotion?: any;
-  maskMotion?: any;
-  arrow?: any;
+  popupMotion?: CSSMotionProps;
+  maskMotion?: CSSMotionProps;
+  arrow?: boolean | ArrowTypeOuter;

Also applies to: 13-32

src/UniqueProvider/index.tsx (1)

111-123: 未使用的 subPopupElements 存储（重复建议）

仅注册从未读取，建议移除或补充用途，避免无谓状态。

src/UniqueProvider/useTargetState.ts (2)

37-39: 注释表意不准（重复建议）

这里的 setOptions(nextOptions) 并非“函数式更新”；建议简化注释，避免误导。

-        // Use functional update to ensure re-render is always triggered
+        // Set new options

---

54-56: 同上，简化待应用选项的注释

避免“functional update”措辞。

-        // Apply pending options - Use functional update to ensure re-render is triggered
+        // Apply pending options

assets/index.less (1)

89-91: 避免使用 transition: all，限定过渡属性以减少重排与性能风险。

若仅期望淡入/位移过渡，请明确具体属性。

-    &-visible {
-      transition: all 0.1s;
-    }
+    &-visible {
+      transition: opacity 0.1s, transform 0.1s;
+    }

src/hooks/useDelay.ts (1)

13-23: 稳定回调引用并夹紧负延时，避免不必要重渲染与边界值问题。

• 用 useCallback 稳定 delayInvoke 引用，降低依赖项波动；
• 负数延时按 0 处理更健壮；
• 明确单位为“秒”，减少误用。

 export default function useDelay() {
   const delayRef = React.useRef<ReturnType<typeof setTimeout> | null>(null);

   const clearDelay = () => {
     if (delayRef.current) {
       clearTimeout(delayRef.current);
       delayRef.current = null;
     }
   };

-  const delayInvoke = (callback: VoidFunction, delay: number) => {
+  /**
+   * delay 单位：秒
+   */
+  const delayInvoke = React.useCallback((callback: VoidFunction, delay: number) => {
     clearDelay();

     if (delay === 0) {
       callback();
     } else {
-      delayRef.current = setTimeout(() => {
+      const ms = Math.max(0, delay * 1000);
+      delayRef.current = setTimeout(() => {
         callback();
-      }, delay * 1000);
+      }, ms);
     }
-  };
+  }, []);

src/UniqueProvider/MotionContent.tsx (1)

11-32: 可选：轻量场景下用 React.memo 避免子树反复渲染。

visible 恒为 true 且仅 appear，组件重渲染主要来自父级。若 children 内容稳定，可包一层 memo 以减少无效渲染。

-const MotionContent = (props: MotionContentProps) => {
+const MotionContent = React.memo((props: MotionContentProps) => {
   // ...
-};
+});

src/hooks/useOffsetStyle.ts (1)

28-34: 类型安全与健壮性小建议。

• 访问 align._experimental?.dynamicInset 使用 as any，可考虑在本仓库的 AlignType 扩展一个可选字段，减少 any；
• points[0] 的字符访问依赖二字符格式（如 br、tl），若存在非预期值建议在开发环境做断言。

docs/examples/two-buttons.tsx (1)

49-58: 去重 popupStyle，减少重复。

两个 Trigger 使用相同样式，抽成常量更简洁。

-import Trigger, { UniqueProvider } from '@rc-component/trigger';
+import Trigger, { UniqueProvider } from '@rc-component/trigger';
 import React, { useState } from 'react';
 import '../../assets/index.less';
 
 const LEAVE_DELAY = 0.2;
 
+const popupStyle: React.CSSProperties = {
+  border: '1px solid #ccc',
+  padding: 10,
+  background: 'white',
+  boxSizing: 'border-box',
+};
+
 // ...
           popup={<div>这是左侧按钮的提示信息</div>}
-          popupStyle={{
-            border: '1px solid #ccc',
-            padding: 10,
-            background: 'white',
-            boxSizing: 'border-box',
-          }}
+          popupStyle={popupStyle}
 // ...
           popup={<div>This is the tooltip for the right button</div>}
-          popupStyle={{
-            border: '1px solid #ccc',
-            padding: 10,
-            background: 'white',
-            boxSizing: 'border-box',
-          }}
+          popupStyle={popupStyle}

Also applies to: 74-79

src/UniqueProvider/FloatBg.tsx (1)

88-96: 可选：为容器添加无障碍与命中忽略属性。

若 FloatBg 仅作视觉背景，建议 aria-hidden 或 role="presentation"，并配合 CSS pointer-events: none（已在样式建议中），避免影响可达性与交互。

-          <div
+          <div
             className={cls}
-            style={{
+            aria-hidden
+            role="presentation"
+            style={{
               ...offsetStyle,
               ...sizeStyle,
               ...motionStyle,
             }}
           />

tests/unique.test.tsx (3)

6-8: 为 global.openChangeLog 增加类型声明，避免 TS 下的隐式 any/属性不存在错误。

-// Mock FloatBg to check if open props changed
-global.openChangeLog = [];
+// Mock FloatBg to check if open props changed
+declare global {
+  // 记录 FloatBg open 属性变化
+  // eslint-disable-next-line no-var
+  var openChangeLog: Array<{ from: boolean; to: boolean }>;
+}
+global.openChangeLog = [];

---

36-39: 补充计时器与 mock 清理，降低测试间耦合。

 afterEach(() => {
   cleanup();
-  jest.useRealTimers();
+  jest.clearAllTimers();
+  jest.useRealTimers();
+  jest.clearAllMocks();
 });

---

84-86: 确认假定的延时推进步长足以覆盖 mouseLeaveDelay。

当前 awaitFakeTimer() 每次推进 100ms 共 10 次，覆盖 0.1s 延时充足，但若未来修改 mouseLeaveDelay，建议直接推进目标时长，提升可读性与鲁棒性。

src/Popup/index.tsx (3)

15-17: useEvent 导入路径不一致，建议统一为 lib 子路径

此处从包根导出拿 useEvent，其它文件使用的是 @rc-component/util/lib/hooks/useEvent。为避免多入口导致的额外体积或多实例问题，建议统一到 lib 路径。

-import useOffsetStyle from '../hooks/useOffsetStyle';
-import { useEvent } from '@rc-component/util';
+import useOffsetStyle from '../hooks/useOffsetStyle';
+import useEvent from '@rc-component/util/lib/hooks/useEvent';

---

65-66: children 类型过窄，放宽为 ReactNode 提升可用性

当前仅允许单个 ReactElement，不支持 Fragment、字符串或数组。建议改为 React.ReactNode。

-  children?: React.ReactElement;
+  children?: React.ReactNode;

---

188-195: Resize → onAlign 可能造成抖动/循环触发

onInternalResize 每次尺寸变化即调用 onAlign，若对齐样式影响布局，可能触发连续的 Resize。建议微任务/RAF 合并对齐调用。

-  const onInternalResize: ResizeObserverProps['onResize'] = useEvent(
-    (size, ele) => {
-      onResize?.(size, ele);
-      onAlign();
-    },
-  );
+  const onInternalResize: ResizeObserverProps['onResize'] = useEvent(
+    (size, ele) => {
+      onResize?.(size, ele);
+      if (!resizeAlignLockRef.current) {
+        resizeAlignLockRef.current = true;
+        Promise.resolve().then(() => {
+          resizeAlignLockRef.current = false;
+          onAlign();
+        });
+      }
+    },
+  );

在上述变更处上方补充（同文件内）：

// 放在 Resize 区块顶部
const resizeAlignLockRef = React.useRef(false);

请在包含复杂动画或动态内容的场景下验证是否仍有循环触发。

src/context.ts (1)

22-23: 可进一步收紧 popupPlacement 类型

如有内置集合，考虑改为 keyof BuildInPlacements 提示合法值；若需支持自定义 placement，保持 string 不变也可。

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

src/UniqueProvider/useTargetState.ts (2)

37-38: 注释与实现不符：此处并非“函数式更新”

setOptions(nextOptions) 不是函数式更新，且也无需函数式更新来触发重渲染。建议简化注释以避免误导。（与先前机器人评论相同问题）

-        // Use functional update to ensure re-render is always triggered
+        // Set new options
         setOptions(nextOptions);

---

49-57: 进入动画结束后应用待处理项 — LGTM

逻辑清晰：先 setIsAnimating(false)，再应用 pendingOptionsRef 并清空。与先前建议“简化注释为 Apply pending options”一致。

src/UniqueProvider/useTargetState.ts (3)

10-13: 文档与实现语义需更精确对齐（仅等待进入动画，不处理离场队列）

当前注释容易被理解为“切换 target 一律等待上一个弹层动画结束”。实现上仅在“进入动画时”缓存并延后应用；离场阶段并未做等待或排队。建议把注释改得更明确，避免误读。

可考虑如下微调注释：

- *  a. We wait motion finish of previous popup.
- *  b. Then we set new target and show the popup.
- * 4. During appear/enter animation, cache new options and apply after animation completes.
+ *  a. 若当前处于出现/进入动画，等待动画完成后再切换；
+ *     若已稳定显示，则可直接切换到新 target（不等待离场动画）。
+ * 4. 仅在 appear/enter 动画期间缓存新 options，动画完成后一次性应用。

---

17-19: “cacheOptions” 命名与行为不完全匹配

返回的第三项是“已应用”的最近一次 options（关闭时也保留），并非“待应用缓存”。建议更新注释或改名为 currentOptions/appliedOptions 以减少歧义；如果不改名，至少把注释改成“当前已应用的 options（可能为 null）”。

-  /* Will always cache last which is not null */
-  cacheOptions: UniqueShowOptions | null,
+  /* 当前已应用的 options；初始为 null，关闭时不清空以保留上次配置 */
+  cacheOptions: UniqueShowOptions | null,

---

41-44: 是否需要跟踪“离场动画”并在离场期间排队新请求？

当前仅在进入动画（!open -> open）置 isAnimating=true；离场时未置位，意味着离场期间的再次 trigger(newOptions) 会立即重开而不是等待离场完成。若产品期望“离场也等待”，需要在隐藏时标记离场动画，并在 onVisibleChanged(false) 决策是否应用排队项；否则建议在注释中明确“仅等待进入动画”。

Also applies to: 59-61

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

src/index.tsx (1)

337-350: 受控模式下仅监听 mergedOpen，属性变更未同步到 Provider（重复提醒）

当受控且处于打开状态时，变更 popup/placement/align/zIndex/mask/arrow 等不会推送到 UniqueProvider，内容/位置可能不更新。需新增一个 effect 在受控+已开时同步最新选项。

 useLayoutEffect(() => {
   if (uniqueContext && unique && targetEle && !openUncontrolled) {
     if (mergedOpen) {
       Promise.resolve().then(() => {
         uniqueContext.show(getUniqueOptions(0));
       });
     } else {
       uniqueContext.hide(0);
     }
   }
 }, [mergedOpen]);

+// 受控 + 已打开：属性变化时也需同步给 UniqueProvider
+useLayoutEffect(() => {
+  if (uniqueContext && unique && targetEle && !openUncontrolled && mergedOpen) {
+    uniqueContext.show(getUniqueOptions(0));
+  }
+  // 这些依赖变化时推送最新选项
+}, [
+  uniqueContext,
+  unique,
+  targetEle,
+  mergedOpen,
+  openUncontrolled,
+  prefixCls,
+  popupClassName,
+  popupStyle,
+  popupPlacement,
+  builtinPlacements,
+  popupAlign,
+  zIndex,
+  mask,
+  maskClosable,
+  popupMotion,
+  maskMotion,
+  arrow,
+  getPopupContainer,
+  popup,
+]);

另外请补充用例：受控打开态下修改 placement/align/popup，期望 Unique 弹层即时更新。

src/index.tsx (5)

114-118: unique 属性文档小措辞与默认值说明

• 注释建议：shared → share（“to share the floating popup”）。
• 补充“默认值：false”，便于使用方理解。

-  /**
-   * Config with UniqueProvider to shared the floating popup.
-   */
+  /**
+   * Work with UniqueProvider to share the floating popup. Default: false.
+   */
   unique?: boolean;

---

289-296: 避免每次渲染创建新的 arrow 对象（减少不必要更新）

当前每次渲染都会创建新对象，可能导致依赖浅比较的子组件/Provider 误判变化。用 useMemo 稳定引用。

-  const innerArrow: ArrowTypeOuter = arrow
-    ? {
-        // true and Object likely
-        ...(arrow !== true ? arrow : {}),
-      }
-    : null;
+  const innerArrow: ArrowTypeOuter = React.useMemo(
+    () =>
+      arrow
+        ? {
+            // true and Object likely
+            ...(arrow !== true ? arrow : {}),
+          }
+        : null,
+    [arrow],
+  );

---

316-335: UniqueProvider 选项组装基本完整；建议同步必要字段并稳定引用

• 如 UniqueProvider 需要“fresh/alignPoint/onPopupClick”等，请一并透传，避免行为偏差。
• 另可将 getUniqueOptions 返回对象通过 useMemo 组合（或确保内部字段引用稳定），降低无效 diff。

     const getUniqueOptions = useEvent((delay: number = 0) => ({
       popup,
       target: targetEle,
       delay,
       prefixCls,
       popupClassName,
       popupStyle,
       popupPlacement,
       builtinPlacements,
       popupAlign,
       zIndex,
       mask,
       maskClosable,
       popupMotion,
       maskMotion,
       arrow: innerArrow,
       getPopupContainer,
+      fresh,
+      // 若 Provider 侧支持以下字段也可补充：
+      // alignPoint,
+      // onPopupClick,
       id,
     }));

---

503-507: forceAlign 在 Unique 模式下无效，应转由 Provider 侧对齐

当前 forceAlign 仅调用本地 triggerAlign，在 Unique 模式下并未渲染本地 Popup，因此无效果。可在 Unique 路径下通过 uniqueContext.show(getUniqueOptions(0)) 触发一次刷新/对齐（若 Provider 提供更合适的 realign/update API 优先使用）。

-    React.useImperativeHandle(ref, () => ({
-      nativeElement: externalForwardRef.current,
-      popupElement: externalPopupRef.current,
-      forceAlign: triggerAlign,
-    }));
+    React.useImperativeHandle(ref, () => ({
+      nativeElement: externalForwardRef.current,
+      popupElement: externalPopupRef.current,
+      forceAlign: () => {
+        if (uniqueContext && unique) {
+          // 触发 Provider 侧重新计算（若有 realign API 可替换）
+          uniqueContext.show(getUniqueOptions(0));
+        } else {
+          triggerAlign();
+        }
+      },
+    }));

请确认 UniqueProvider 是否已有对齐专用 API（如 realign(id)），若有可替换为该 API。

---

618-627: Unique 模式下的“窗口点击关闭”判定可能与 Provider 重叠/冲突

useWinClick 的“是否点在弹层内”依赖 popupEle/subPopupElements。Unique 模式不渲染本地 Popup 时，这些引用为空，可能误判为外部点击而多触发一次关闭，与 Provider 的点击关闭逻辑叠加。

• 验证场景：Unique 模式 + clickToHide/maskClosable，点击弹层内部是否被本地逻辑误判为外部点击。
• 若复现：建议在 Unique 模式下让 useWinClick 处于“禁用”态（例如 hook 内根据 disabled 参数直接 no-op），或让 UniqueContext 暴露“判断是否在 Unique 弹层内”的能力以复用。

Also applies to: 779-834

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro